home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / programer2 / sdls / !!ReadMe next >
Encoding:
Text File  |  1995-08-09  |  7.8 KB  |  226 lines

  1. SDLS RELEASE 1.03 RELEASE NOTE
  2.  
  3. _____________________________________________________________________________
  4.  
  5.  
  6. Important note
  7.  
  8.  
  9.         For corrections to the original manual, and documentation on features
  10.         added to SDLS since the manual was written, see the file `Errata'.
  11.  
  12. _____________________________________________________________________________
  13.  
  14.  
  15. Archive contents
  16.  
  17.  
  18.         This is SDLS release 1.03.  It contains the following components:
  19.  
  20.           * DLLManager 1.12
  21.           * cdll 1.07
  22.           * DLLMerge 1.11
  23.  
  24.         This archive should contain the following files:
  25.  
  26.                 !!ReadMe                [This file]
  27.  
  28.                 !cdll                   [DDE frontend for cdll tool]
  29.                   !Run
  30.                   !Setup
  31.                   !Sprites
  32.                   Desc
  33.                   Messages
  34.                   Template2D
  35.                   Template3D
  36.                   Templates
  37.  
  38.                 !DLLMerge               [DLLs resource merging tool]
  39.                   !Help
  40.                   !Run
  41.                   !RunImage
  42.                   !Sprites
  43.                   Sculptrix
  44.  
  45.                 !DLLs                   [DLLs resource]
  46.                   !Boot
  47.                   !Run
  48.                   !Sprites
  49.                   !Sprites22
  50.                   DLLManager
  51.                   enumerate
  52.                   Examples
  53.                     DLLExample
  54.                   hour
  55.                   pathUtil
  56.  
  57.                 cdll                    [DLL header/stub generating tool]
  58.  
  59.                 DLLLib                  [SDLS support library]
  60.                   h
  61.                     ctype
  62.                     dll
  63.                     errno
  64.                     math
  65.                     stdio
  66.                     swiv
  67.                   o
  68.                     asstubs
  69.                     astubs
  70.                     DLLLib
  71.                     dstubs
  72.                     msstubs
  73.                     mstubs
  74.                     swiv
  75.  
  76.                 Errata                  [Alterations to the manual]
  77.  
  78.                 Manual                  [The SDLS manual, in text and Draw]
  79.                   Fig_1,1
  80.                   Fig_1,2
  81.                   Fig_10,1
  82.                   manText
  83.                   Table_10,1
  84.                   Table_11,1
  85.  
  86.                 Tutorials               [Files used in SDLS tutorial]
  87.                   ClientEx
  88.                     c
  89.                       clientEx
  90.                     h
  91.                       dllExample
  92.                     o
  93.                       clientEx
  94.                       dllExample
  95.  
  96.  
  97.         Note that a version of the manual in Impression Publisher format
  98.         should be available from the same place you obtained this archive.
  99.  
  100. _____________________________________________________________________________
  101.  
  102.  
  103. Revision history
  104.  
  105.  
  106.     Release 1.03
  107.  
  108.         * Rearranged DLLManager's slightly insane workspace layout -- now
  109.           uses R12 to contain the address of the workspace, instead of a
  110.           strange relocation.  This makes the module slightly smaller, and
  111.           simplifies the build process.  In addition, it allows the
  112.           workspace to be examined by Zap in the normal way.
  113.  
  114.         * Extended syntax of DLL names (now termed DLL Absolute Names)
  115.           passed to DLL_Find, DLL_FindFromTable and *DLLEnsure, to support
  116.           DLLs in directory heirarchies (such as DeskLib):
  117.  
  118.             - Amended DLLManager to support the new-style DANs.
  119.  
  120.             - Modified cdll to accept longer DLL names and to generate the
  121.               new-style DANs.
  122.  
  123.             - Added documentation about the new names to the Errata file.
  124.  
  125.         * Allowed DLL and application names to be terminated by space
  126.           characters, largely to support Sam Kington's CLI Guardian program
  127.           which insists upon appending a space to its command lines.
  128.  
  129.         * More DLLMerge updates (although none which really make any
  130.           external difference):
  131.  
  132.             - Moved the messages into a separate file and bound them into
  133.               the image at link-time.  This should make different language
  134.               versions of the application easier to produce.
  135.  
  136.             - Subtly moved the icons in the two dialogue boxes so that
  137.               they're all on 4 OS-unit boundaries.
  138.  
  139.             - Changed string substitution routine to allow `%0' as first
  140.               string, rather than `%1', for consistency with Sapphire.
  141.               Updated messages resource in line with this change.
  142.  
  143.         * Updated DLLManager further:
  144.  
  145.             - Moved all of the language dependent messages into a message
  146.               file, which is bound into the module at link time, for the
  147.               sake of internationalisation.
  148.  
  149.             - Changed string substitution routine to allow `%0' as first
  150.               string, rather than `%1', for consistency with Sapphire.
  151.               Updated messages resource in line with this change.  Also
  152.               slightly modified some messages.
  153.  
  154.             - Fixed a bug: it used the DAN instead of the DLL name to check
  155.               if a DLL was already registered with an application.  This
  156.               caused DLLs whose DANs weren't equal to their names to have
  157.               their reference counts incremented erroneously.  It now
  158.               correctly extracts the DLL name from the DAN.
  159.  
  160.         * Removed `screen' sprites from !DLLs Sprites and Sprites22 files.
  161.           These sprites corrupted the display in MakeModes, and used up
  162.           memory space once added to the Wimp sprite pool.
  163.  
  164.         * Rearranged DLLLib's internal structure slightly.  There was some
  165.           inappropriate grouping of routines into object files which caused
  166.           problems if you tried loading extension DLLs from a shared library.
  167.           (Further to this: the structure has been put back, because it
  168.           caused nasty branch through zero errors -- the problem has since
  169.           been fixed by restoring the old structure and IMPORTing __errno
  170.           with a `WEAK' attribute.)
  171.  
  172.  
  173.     Release 1.02
  174.  
  175.         * Found a bug in link 4.00, which was used in the release 1.01 build.
  176.           The old linker was setting apparently random bits in the AREA
  177.           attributes when it was partially linking the stubs files, which
  178.           generated unsightly (but unimportant) warnings when used with
  179.           link 5.xx.  I now fix the attributes by hand after link has
  180.           finished its work.
  181.  
  182.         Don't be alarmed if you never saw release 1.01 -- it only existed
  183.         for about a day before the link error was spotted.
  184.  
  185.  
  186.     Release 1.01
  187.  
  188.         * Fixed bugs in DLLManager's dll/app link caching.
  189.  
  190.         * Altered build for dllstubs and dlllib to use old assembler, linker
  191.           and librarian, to prevent problems with people using pre-C/C++
  192.           linkers.
  193.  
  194.         * Several minor changes to DLLMerge:
  195.  
  196.             - Embedded window templates in the main image.  This makes it
  197.               much faster at loading, particularly from floppy disk.
  198.  
  199.             - Reorganised directory structure within application:
  200.  
  201.                 o Resources is now empty, so it's been removed.
  202.  
  203.                 o Modules only contained Sculptrix, so that's been moved
  204.                   into the main directory.  It was only there for update's
  205.                   benefit anyway.
  206.  
  207.             - Reduced the size of the image considerably, although it doesn't
  208.               seem possible to fit it into a 4K wimpslot.
  209.  
  210.             - Now that AOF allows ADRLs to be relocated, I've been able to
  211.               remove all the mucky LDR Rx,=<addr>s so it's all position
  212.               independent now.
  213.  
  214.         * Corrected documentation of dll.h macros (see Errata).
  215.  
  216.         * Fixed textual version of manual to use spaces instead of tabs,
  217.           which don't work properly in Edit and similar editors.
  218.  
  219.  
  220.     Release 1.00
  221.  
  222.         * Initial release versions of all components.
  223.  
  224. _____________________________________________________________________________
  225.  
  226.